home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 083 / phnxdoc.arc / PHNXDOC.6 < prev    next >
Encoding:
Text File  |  1987-12-04  |  7.0 KB  |  198 lines
  1.  
  2.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  3.  
  4.          6.0  USING QUESTIONNAIRES
  5.  
  6.              Phoenix uses a simple procedure to generate Questionnaires.
  7.  
  8.              Questionnaires are simple text files that are interpreted by
  9.              Phoenix. There is a very simple line-oriented pseudo-language
  10.              that interprets these scripts. There are only a couple of
  11.              "commands", and only two crude conditionals.
  12.  
  13.              The answers to the questionnaire are put in a separate file,
  14.              without the questions. They are also normal ASCII text, but in a
  15.              fixed field format with field characters, to make post-
  16.              processing of the questionnaire easier.
  17.  
  18.              The questionnaire consists of two files:
  19.  
  20.                        FIRSTNAME.QST    The questionnaire script
  21.                        FIRSTNAME.ANS     The answers
  22.  
  23.              Answers are appended to the end of the answer file; it is
  24.              created if it does not exist. The first name of the
  25.              answers file will correspond with the first name of the
  26.              questionnaire so , with multiple questionnaire files, you
  27.              will not get confused which is the proper answers file.
  28.  
  29.              You may define almost ANY number of different questionnaires
  30.              to use in Phoenix and may even have a questionnaire menu!
  31.  
  32.              The questionnaire name may be any LEGAL DOS FIRST NAME.
  33.              Be SURE, when creating the questionnaire, to use the
  34.              extension QST for the file. SEE THE SECTION FOR PHOENIX
  35.              MENU SYSTEM PLUS (tm) to find out how to place a questionnaire
  36.              into your menu system. If you accepted our defaults for
  37.              a new user questionnaire, then you already have one to
  38.              try out and see how it works. The command is in the
  39.              main menu (menu0.mnu).
  40.  
  41.              The first character of each line tells Phoenix what to do with
  42.              the line. This first character is a normal printable character.
  43.              If the first character is not one of the known commands, the
  44.              line is merely displayed.
  45.  
  46.  
  47.              The questionnaire commands are:
  48.  
  49.              /<prompt string>
  50.              Display <prompt string>, then input a single line of text.
  51.              Maximum line length is 78 characters. The usual editing is
  52.              available. The inputted text is written to the answer file.
  53.  
  54.  
  55.              *
  56.              Put user info to the answer file: name and last (current) sign-
  57.              on date. Useful for the "what kind of system ..."-type
  58.              questionnaires. Leaving this out allows confidential
  59.              questionnaires, as there is no other record of which caller
  60.              filled one in.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  69.  
  70.              +N <prompt string>
  71.              Multiple choice. The single digit number N is the number of
  72.              possible choices (1 - 9).  If an illegal number is entered, or
  73.              the number is missing, the number of choices defaults to one
  74.              but at least the system won't hang up.
  75.              The choice entered by the user
  76.              is checked for in range 1 to N, and saved in the answer file.
  77.  
  78.              There is a special feature of multiple choice: an internal flag
  79.              is set if the last choice (choice N) is selected, that can be
  80.              tested by the ! command, described below.
  81.  
  82.              !
  83.              To be used ONLY after a multiple choice question. If the last
  84.              choice of a multiple choice was selected, this terminates the
  85.              questionnaire. Allows asking "Do you want to fill this out (1)
  86.              yes (2) no".
  87.  
  88.              _ (Underscore)
  89.              Unconditionally clears the conditional flag.
  90.  
  91.              Below is an example of a new user questionnaire we have
  92.              named NEWUSER.QST:
  93.  
  94.               NEW USER INFORMATION
  95.               ~~~~~~~~~~~~~~~~~~~~~~
  96.               You are required to Register to this System. Please fill
  97.               out the following questionnaire.
  98.  
  99.               Your access will be upgraded within 48 hours.
  100.  
  101.               Thank you for your cooperation!
  102.  
  103.             *
  104.             +2Have you Registered with this Phoenix board before? (1)No (2)Yes
  105.             !
  106.             / What is your real name (first & last):
  107.             / What is your Street Address:
  108.             / City, State, Zip:
  109.             / What is your voice phone no.:
  110.             / Where did you hear about this board:
  111.             / What is your age:
  112.  
  113.  
  114.              Your NEWUSER.ANS would be an ASCII file with the user's
  115.              answers to your questionnaire.  The answers would look like the
  116.              following:
  117.                     1:-> User #100, John Doe, 01 Jan 87
  118.                     2:1
  119.                     3:John A. Doe
  120.                     4:1234 Any Street
  121.                     5:Any town, ST, 12345
  122.                     6:555/555-5342
  123.                     7:The Aztec BBS
  124.                     8:23
  125.              Each time the questionnaire was invoked, the answers would be
  126.              appended to NEWUSER.ANS. Note, if the caller had answered "2" to
  127.              the first question, the questionnaire would have been
  128.              terminated.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.       PHOENIX REMOTE COMMUNICATIONS SYSTEM                  DECEMBER 4, 1987
  135.  
  136.              One of the easiest ways to read your answer files, is to
  137.              place the answers file name (in this case, NEWUSER.ANS) into
  138.              a dumpfile class menu call. You may then read the file
  139.              right from within Phoenix. Be sure to thoroughly read and
  140.              understand the section on PHOENIX MENU SYSTEM PLUS (tm) where
  141.              dumpfile class calls are explained!
  142.              This is, we feel, the most powerful menu system for bulletin
  143.              boards available today and it will literally allow you TOTAL
  144.              flexibility in configuring your system for features and
  145.              convenience.
  146.  
  147.              If a caller selects a Questionnaire from one of your menus and
  148.              the questionnaire file does not exist,
  149.              your caller will receive the following message:
  150.  
  151.                              "Sorry, No questionnaire today"
  152.  
  153.              If you are not going to have a Questionnaire on your bulletin
  154.              board, we recommend that you:
  155.                 1. raise the access level high enough so the
  156.                    questionnaire command cannot be seen by anyone.
  157.                 2. simply remove the command from your menu.
  158.  
  159.               This will keep the screen clean, and will not confuse
  160.               callers or waste their long distance dollars trying to
  161.               figure out that they are really doing nothing wrong, the
  162.               questionnaire simply does not exist.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.